Skip to content

Add help case agent skill: file a case, add a comment with a working link - #26

Merged
Ekwuno merged 1 commit into
Workday:mainfrom
Daksh-Aneja-Projects:add-help-case-agent-skill
Nov 12, 2026
Merged

Ekwuno merged 1 commit into
Workday:mainfrom
Daksh-Aneja-Projects:add-help-case-agent-skill

Conversation

@Daksh-Aneja-Projects

Copy link
Copy Markdown
Contributor

What this PR adds or changes

One agent skill, help-case-agent-skill: route an HR question to the right help case type, prepare the case for
approval, and prepare a comment on an existing case.

It also documents something I could not find written down: how to put a working link in a help case comment through
the REST API. A question on the developer forum asked for exactly this, so the skill carries the tested request shape.

Checklist for new or changed examples

  • The example lives entirely in its own folder under examples/
  • node scripts/validate-examples.mjs --check passes (valid example.json, README present, index table in sync)
  • The README says what the artifact is, how to use it, and what to change before deploying it (the "Before you deploy" section)
  • No credentials, tenant names, or real personal data anywhere in the folder
  • node scripts/audit-examples.mjs --changed passes, or the findings it reports are explained below

Anything reviewers should know?

  • The audit was run with --skip-arcane (hub rules only); the folder holds markdown and JSON, no Extend source.
  • Every operation in SKILL.md was run on a development tenant on 11 November 2026 with helpCase/v4, and each comment
    was checked on the case page. What that showed:
    • comment.textBody is plain text. An address or an <a> tag in it is shown as typed and is not clickable.
    • comment.content takes a rich text document as a string. A link mark on a text node is drawn as a link, and it is
      the same shape the case page's own editor writes when an address is typed.
    • The page builds the link from the node's text, not from href, so the link text has to be the address itself.
    • Sending textBody and content together is refused with a 400.
  • This is behaviour observed on one tenant, not taken from documentation, and the README says so. If the team knows of
    a documented rule for link labels, I will gladly correct the skill.
  • Kept separate from Add four agent skills: expense report, time tracking, worker data quality, learning enrolment #25 so each can be reviewed on its own.

🤖 Generated with Claude Code

…link

Covers helpCase/v4 case creation, the timeline read and the comment write,
including the rich text content shape for a clickable link. Every operation
was run on a development tenant and checked on the case page.
@github-actions

Copy link
Copy Markdown

Example audit

Audited examples/help-case-agent-skill. No findings. Thank you for a clean submission.

Run it yourself: ./scripts/install-arcane.sh once, then node scripts/audit-examples.mjs --changed. Rule explanations and fixes: docs/EXAMPLE_BEST_PRACTICES.md.

@Ekwuno
Ekwuno merged commit b2fdafa into Workday:main Nov 12, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants